登入

按照官網的說法我們來寫一個簡單的登入

import shioaji as sj

api = sj.Shioaji()
accounts =  api.login(api_key="請到永豐網站申請取得", 
                      secret_key="請到永豐網站申請取得"
                      )

api.logout()

這樣就登入成功了！！！
但是注意因為永豐限制登入連線帳號數量，所以要記得登出api.logout()

檢查連線細節

print(accounts)

將以上程式碼加上這一行可以檢驗連線的狀況。
你會得到：

Response Code: 0 | Event Code: 0 | Info: host '203.66.91.161:80', hostname '203.66.91.161:80' IP 203.66.91.161:80 (host 1 of 1) (host connection attempt 1 of 1) (total connection attempt 1 of 1) | Event: Session up
[StockAccount(person_id='身分證', broker_id='9DFSDF5', account_id='073SDFSDF80', username='你名字')]

Contract

Contract物件是API的核心，因為他是商品的基本資料，需要以此物件指定要獲取的金融商品資料，有三種寫法，都是等價的：

api.Contracts.Stocks.TSE.TSE2890 #使用SYMBOL
api.Contracts.Stocks.TSE['2890'] #使用CODE
api.Contracts.Stocks['2890'] #使用CODE

以下是相關的屬性表格：

Snapshots

就是用來抓取股票當下的資訊，因此我們只需要傳入Contract組成的List，回傳就會是一個lsit

contracts = [api.Contracts.Stocks['2330'], api.Contracts.Stocks['2890']]
snapshots = api.snapshots(contracts)

Ticks

tick又為成交明細，是每一筆成交的時間、數量、價格等等資訊的物件。我們一般盤後可以仰賴這個物件提供資料，以下是參數：

Subscribe 訂閱盤中報價資訊(Futures)

對於程式交易，在盤中時需要取得即時的報價和成交資訊。儘管可以使用快照 (snapshots) 或 K 線 (kbars) 來獲取盤中資訊，但這兩種方法都會消耗較多資源。透過訂閱 (subscribe) 的方式，您可以同時訂閱多個金融商品的即時報價和成交資訊，並為回傳的內容編寫相應的執行動作（程式）。

與其他報價資訊相比，目前訂閱功能允許最多同時訂閱200個不同內容。

若要取消訂閱，可呼叫api.quote.unsubscribe，使用方式及參數與subscribe相同。

訂閱之後市場只要有成交就會回傳一筆資料。

以下是範例：

from shioaji import TickSTKv1, Exchange, Shioaji, constant
from threading import Event # event模組用於維持程式運作
import os

api = Shioaji()
accounts =  api.login(api_key=os.getenv('API_KEY'), 
                      secret_key=os.getenv('SECRET_KEY')
                      )

#訂閱個股盤中tick資訊
api.quote.subscribe(
    api.Contracts.Stocks["2330"], 
    quote_type = constant.QuoteType.Tick,
    version = constant.QuoteVersion.v1
)

# 維持程式運作等待交易資料送入
Event().wait()

# 定義quote_callback，即回傳報價資訊時所要執行的動作
@api.on_tick_stk_v1()
def quote_callback(exchange: Exchange, tick:TickSTKv1):
    print(f"Exchange: {exchange}, Tick: {tick}") #將報價資訊內容輸出

api.logout()

交易股票時還有委買委賣的部分也可以讓API回傳，修改一下12、31行就可以了：

from shioaji import Exchange, Shioaji, constant, BidAskSTKv1
from threading import Event # event模組用於維持程式運作

api = Shioaji()
accounts =  api.login(api_key="9EwVF2HtBmfeexfLBYUExWvFbaL6f1jenPfxESjSo4x5", 
                      secret_key="5BW5ZxGc3Vz186y5EzhCeg7b25qC3bD2kk823t9L7kyx"
                      )

#訂閱個股盤中tick資訊
api.quote.subscribe(
    api.Contracts.Stocks["2330"], 
    quote_type = constant.QuoteType.BidAsk,
    version = constant.QuoteVersion.v1
)

# 維持程式運作等待交易資料送入
Event().wait()

# 定義quote_callback，即回傳報價資訊時所要執行的動作
@api.on_tick_stk_v1()
def quote_callback(exchange: Exchange, tick:BidAskSTKv1):
    print(f"Exchange: {exchange}, Tick: {tick}") #將報價資訊內容輸出

api.logout()

下單電子憑證

下單需要下單的憑證(不然誰下單都行，太不安全了)，啟用憑證前要先登入LOGIN，未來在CloudRun會將路徑等等寫在環境數中，這裡先這樣寫吧：

result = api.activate_ca(
    ca_path=os.getenv('YOUR_CA_PATH'), # 下單電子憑證路徑及檔案名稱
    ca_passwd=os.getenv('YOUR_CA_PASS'), # 下單電子憑證密碼
    person_id=os.getenv('YOUR_PERSON_ID'), # 身份證字號
)

電子憑證啟用成功，則回傳的result就會是True

委託

Order建立

在下單之前我們要建立Order物件，直接使用這個程式碼order = api.Order()代入參數如下：

委託單建立、修改及取消

已經把order建立起來了，要發出委託就要使用以下的函式：

api.place_order(
        contract: Contract,
        order: Order,
        timeout: int = 5000
    )

修改：

api.update_order(
        trade: Trade, #傳入原本的委託單
        price: typing.Union[StrictInt, float] = None, #變更後的委託價格
        qty: int = None, #qty指的是所要取消的委託數量
        timeout: int = 5000
    )

刪除：

api.cancel_order(
    trade: shioaji.order.Trade,
    timeout: int = 5000
)

帳務

我們肯定會需要查庫存：

api.list_positions(
    account: shioaji.account.Account = None, #交易帳戶，預設為None
    unit: shioaji.constant.Unit = <Unit.Common: 'Common'>, #單位，預設為整股
    timeout: int = 5000 #timeout預設為5000ms，即延遲時間?
)

今天先到這裡我好睏，明天我們就開始準備上雲的工作吧!!!不過明天是假日不能測試。